项目管理应用的 Zapier 集成结构
虽然无法自动执行项目工作，但您可以通过 Zapier 上的应用集成自动添加任务、创建新项目，并跟踪进度。
要在 Platform UI 中添加项目管理应用集成：
先决条件
- 一个 Zapier 帐户。
- 如果您之前未使用过 Zapier，建议先学习基础知识，请参阅我们的 Zapier 入门指南。
- 熟悉您应用 API 文档和可用端点。
- 查看 Platform UI 教程。
1. 为每个项目中的常见记录类型添加触发器
- 查看其他项目管理应用作为触发器使用的 常见记录类型。
- 对于记录类型较多的应用，考虑添加一个 新活动 触发器，并提供选项，让用户选择哪些活动类型应触发 Zap。
- 为新记录和更新记录分别创建单独的触发器。对于项目管理应用，更新 触发器最为实用，因为这些更新会影响待处理的工作。用户需要获知任务截止日期是否变更、是否添加了详细信息或调整了范围、或是否有人完成了相关任务。
- 强烈建议确保触发器行为覆盖所有在您应用用户界面中对已登录用户可见的更新，而不依赖记录类型的管理员或创建者权限。用户期望能够基于任何与他们共享的记录进行自动化，无论他们是否是管理员或创建者。如果您的 API 无法支持此功能，请在触发器描述中明确说明。例如，对于 新笔记 触发器，可以添加帮助文本，如“当 连接 的用户帐户向项目添加笔记时触发。”
- 允许用户筛选他们希望触发的记录。例如，新任务 触发器可在任务添加到任何项目或特定项目时激活。使用 动态下拉菜单，按最近添加的顺序获取帐户、项目、列表等选项，以便用户进行过滤。
- 项目管理记录通常与其他记录在您的应用中关联。如果这些数据在您的应用中对相关记录可见，用户也期望在 Zap 中看到这些信息。例如，新任务 触发器应包含任务所属项目的详细信息。
- 在响应输出中包含链接数据的 ID，以便将其映射到您应用的动作步骤，同时提供易读的人类可读信息，如项目的名称和描述。
- 如果您的记录 API 端点未自动返回链接记录以外的额外数据（如记录的 ID 或名称），请在触发器 API 调用中添加自定义代码，以获取与记录相关的其他数据。
2. 包含常见的搜索动作
- 用户期望在项目管理集成中提供顶级记录的搜索功能，以便添加子级详细信息。例如，一个项目可能包含多个任务，有些项目任务相似，用户更倾向于使用 查找项目 搜索来添加任务，而不是 查找任务 搜索，这可能无法精确匹配所需项。
- 配置搜索以查找现有记录，并以触发器返回记录的相同格式输出，从而确保体验一致，并使数据可在后续动作中顺畅使用。
- 在适当时，提供多种搜索键和值选项。例如，查找项目 搜索应允许用户按项目 ID 或名称搜索。前者适用于基于先前步骤数据搜索，后者适用于手动输入查找。首先返回精确匹配，并通过帮助文本向用户解释搜索如何匹配记录。
3. 包含常见的创建动作
- 查看其他项目管理应用提供的 常见记录类型 的创建动作。
- 添加相应的 更新 动作，并结合可用的 搜索 动作，帮助用户轻松更新正确的项目记录。
- 在动作输入字段中处理链接记录，确保当您的应用 UI 允许用户创建任务并链接到现有项目时，Zap 中也能实现类似功能，通过 动态下拉菜单 获取并选择链接记录选项。
- 避免让单个动作创建多个记录。当用户通过 Zapier 创建新任务时，仅创建任务，而不应同时创建其他链接记录。相反，应提供单独的动作来创建其他记录，并使用任务更新动作在其他记录创建后进行链接，以减少错误和冗余风险。
- 如果用户需要 Zap 查找正确的相关记录并将 ID 映射到输入字段，则可选择将 搜索连接器 链接到链接记录输入字段。要添加此用户提示，您需要在 Platform CLI 中操作。
4. 测试您的触发器和动作
使用以下标准创建 Zap，以验证您的应用集成是否正常工作：